home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / HAM_RAD / LOGGING / 4127.ZIP / SWL114.ZIP / swlog.doc < prev    next >
Text File  |  1991-12-13  |  33KB  |  733 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                    Short Wave Log
  8.                                     Version 1.13
  9.  
  10.                            Copyright c 1991 Lee Consulting
  11.                                    P.O. Box 71301
  12.                                 Pittsburgh, PA  15213
  13.  
  14.  
  15.           Acknowledgements          Acknowledgements          Acknowledgements
  16.  
  17.           Short Wave Log started out as a series of dBASE/Paradox tables
  18.           and C code.  As the program grew, so did the bugs.  Thanks to the
  19.           great team of beta-testers who not only found the bugs, but also
  20.           gave great suggestions.
  21.  
  22.           The code to spawn Short Wave Log to EMS/XMS memory or disk was
  23.           written by Ralf Brown.
  24.  
  25.           The Finnish language module of the QSL Writer is Copyright c 1991
  26.           Veli-Matti Anttila.  Used with permission.
  27.  
  28.           The Spanish language module of the QSL Writer is Copyright c 1991
  29.           Joe Piskor.  Used with permission.
  30.  
  31.  
  32.           Trademarks          Trademarks          Trademarks
  33.  
  34.           CXL is a trademark of Innovative Data Systems.
  35.           DESQview and QEMM are trademarks of Quarterdeck Office Systems.
  36.           IBMR, PCR, and PC-DOSR are registered trademarks of International
  37.                Business Machines.
  38.           MS-DOSR, HIMEMR, and XMSR are registered trademarks of Microsoft
  39.                Corporation.
  40.           Turbo AssemblerR, Turbo CR, dBASER, and ParadoxR are registered
  41.                trademarks of Borland International.
  42.  
  43.  
  44.  
  45.           Development          Development          Development
  46.  
  47.           Short Wave Log started as a dBASE application and has evolved
  48.           into a Turbo C 2.0/Turbo Assembler 2.0 program using the Paradox
  49.           Engine 1.0 for database functions and the TCXL 5.52.06 library
  50.           for screen management.
  51.  
  52.           Introduction          Introduction          Introduction
  53.  
  54.  
  55.           Many listeners of short wave/international radio log broadcasts.
  56.           With personal computers now affordable to almost everyone,
  57.           listeners can store their logs in a database such as dBASE or
  58.           Paradox or a flat-file database.  This requires the listener not
  59.           only to purchase a database, but also to learn the database
  60.           language.  The Short Wave Log program allows the listener to
  61.  
  62.                                        Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.           enter  logs directly into a database and harness the power of a
  69.           database without the cost and time of purchasing and learning a
  70.           database.
  71.  
  72.           What exactly does the Short Wave Log program do?  Each record of
  73.           a listener's logbook corresponds to a record in a database table.
  74.           The table is indexed so that the listener can sort and print his
  75.           logbook by:
  76.  
  77.                        date and time
  78.                        frequency
  79.                        station name
  80.                        transmitter location
  81.  
  82.           In addition to storing the log entries, Short Wave Log also
  83.           stores station frequencies and addresses, which are used to
  84.           speed-up the entry of logs and QSL requests.  Short Wave Log also
  85.           writes reception reports in a variety of languages: English,
  86.           German, Finnish, Spanish, and Swedish.  More languages will be
  87.           added in subsequent updates.
  88.  
  89.  
  90.  
  91.           Hardware and Software Requirements          Hardware and Software Requirements          Hardware and Software Requirements
  92.  
  93.           Short Wave Log runs on the IBM PC family and on 100% compatibles.
  94.           At least 512 kB of conventional memory is required.  If present,
  95.           approximately 400 kB of EMS or XMS memory is used.  A hard disk
  96.           and at least 2 / MB of free disk space is recommended; however,
  97.           Short Wave Log will also run on a 720 kB or higher capacity
  98.           floppy or RAM drive (although some features will be disabled).
  99.  
  100.           DOS 3.0 or later is required.  With DOS 3.30, Microsoft added
  101.           National Language Support (NLS).  Short Wave Log uses the NLS
  102.           functions to format the date, time, and sort order according the
  103.           country statement in the CONFIG.SYS file.  (See an DOS manual for
  104.           more details.)  The QSL Writer is heavily dependent upon the NLS
  105.           functions and cannot be accessed under DOS 3.0, 3.1, or 3.2.
  106.  
  107.           Short Wave Log places rather heavy demands on the system.  The
  108.           minimum number of file handles recommended is 30.  (Put a
  109.           FILES=30 line in the CONFIG.SYS file.)
  110.  
  111.           Short Wave Log is written to take direct advantage of the
  112.           DESQview multitasking system.  When running under DESQview, all
  113.           screen writes are written to the logical screen buffer.
  114.           Therefore the "Writes Directly to the Screen" option can be set
  115.           to "No" even on 8086/8088/80286 machines.
  116.  
  117.           Short Wave Log is compatible with the EGA 43-line and VGA 50-line
  118.           modes.  Set the monitor to one of these modes before running
  119.           Short Wave Log.  Three batch files (25.BAT, 43.BAT, and 50.BAT)
  120.           are supplied for this purpose.
  121.  
  122.  
  123.                                        Page 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.           Short Wave Log will detect the DOS country code and set the date,
  130.           time, and floating-point formats accordingly.  The sort order of
  131.           the tables is also determined by the country code.  Three sort
  132.           orders are supported: International, Norwegian/Danish (country
  133.           codes 047 and 045), and Swedish/Finnish (country codes 046 and
  134.           358).  The three sort orders differ in how they treat accented
  135.           Roman characters.  The International sort order does not
  136.           differentiate between accented and unaccented characters.  The
  137.           Norwegian/Danish sort order puts accented characters immediately
  138.           after unaccented.  The Swedish/Finnish sort order puts accented
  139.           characters at the end of the alphabet.
  140.  
  141.  
  142.  
  143.           Installation and Upgrading          Installation and Upgrading          Installation and Upgrading
  144.  
  145.           Because of the number of archive programs available for the IBM
  146.           PC and compatibles, Short Wave Log may arrive packaged in almost
  147.           any format.  To extract the file from the archive, follow the
  148.           instructions of the archiving program.  Once the files have been
  149.           extracted to a subdirectory (e.g. C:\SWLOG), the program is ready
  150.           to run.
  151.  
  152.           Upon starting the program for the first time, Short Wave Log
  153.           creates the SWL table in which the log entries are stored.  After
  154.           the SWL table is created, all the tables are keyed.  This can
  155.           take anywhere from one to fifteen minutes, depending on the speed
  156.           of the machine and hard drive.  After the initial keying of
  157.           tables, the program is ready to run.
  158.  
  159.           When upgrading to a new version of Short Wave Log, move the old
  160.           version and its associated files into a temporary directory.
  161.           Extract the new version into the SWLOG directory.  Finally copy
  162.           the *.DB, *.PX, *.X??, and *.Y?? files from the temporary
  163.           directory to the SWLOG directory.  This will copy over the
  164.           starter tables with your own tables.
  165.  
  166.  
  167.           Registration and Support          Registration and Support          Registration and Support
  168.  
  169.           Short Wave Log is distributed as shareware.  It is not and never
  170.           has been in the public domain.  Short Wave Log may be freely
  171.           distributed in any format so long as the archive is kept in tact.
  172.  
  173.           The demonstration program can be used on a trial basis.  If you
  174.           find the program useful, please register by sending $20 (U.S.)
  175.           (check or money order) to Lee Consulting, P.O. Box 71301,
  176.           Pittsburgh, PA 15213.
  177.  
  178.           As an alternative to the registration fee, a language module for
  179.           the QSL Writer can be provided.  In particular French,
  180.           Portuguese, and other European languages are needed.   An
  181.  
  182.  
  183.  
  184.                                        Page 3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.           Internet, CompuServe, or GEnie e-mail address is required for
  191.           this option.  Please contact Lee Consulting for more details.
  192.  
  193.           With registration comes a printed copy of the manual, the latest
  194.           version of the program, and support via either e-mail or
  195.           telephone.  More importantly, you will receive notification of
  196.           updates and new versions.
  197.  
  198.           The latest versions of the Short Wave Log can be found on these
  199.           systems:
  200.  
  201.                       ANARC             913/345-1978
  202.                       Binklink                    412/766-0732
  203.                       CompuServe HamNet Forum
  204.                       GEnie Radio Roundtable
  205.                       Pinelands                   609/859-1910
  206.                       Red Onion Express 914/342-4585
  207.  
  208.           If you have any problems with the program or have any comments --
  209.           positive or negative -- feel free to use one of these e-mail
  210.           addresses:
  211.  
  212.                       CompuServe:       71251,1407
  213.                       Internet:                   71251.1407@compuserve.com
  214.                       GEnie:            R.SILLETT
  215.  
  216.  
  217.  
  218.           Changes from version 1.12 to 1.13          Changes from version 1.12 to 1.13          Changes from version 1.12 to 1.13
  219.  
  220.                       Trap for Escape before entering the Browse function.
  221.                       If run on A: or B:, the program uses only the
  222.                       primary key and blacks out the OS Shell, Browse,
  223.                       Import, and Export functions to conserve disk space.
  224.                       The help file is optional to conserve disk space on
  225.                       floppy installations.
  226.                       Fixed problem where the abbreviation for Afrikaans
  227.                       would not be displayed.
  228.                       The Display Stations function can now display more
  229.                       than 500 stations.
  230.                       The OS Shell function is blacked out if running
  231.                       under DESQview as it can spawn DOS processes.
  232.                       The TCXL video library has been upgraded to 5.52.06.
  233.                       This fixes some anomalies with the data entry forms.
  234.                       The FREQLIST table has been updated with data for
  235.                       winter 1991-92.
  236.                       General clean-up of the documentation.
  237.  
  238.  
  239.           Known Problems          Known Problems          Known Problems
  240.  
  241.  
  242.  
  243.  
  244.  
  245.                                        Page 4
  246.  
  247.  
  248.  
  249.  
  250.  
  251.           There is an incompatibility between the Paradox Engine and the
  252.           Zenith EZpc.  Unfortunately Short Wave Log cannot run on the
  253.           Zenith EZpc.
  254.  
  255.           Some EMS memory managers on 286-based computers are incompatible
  256.           with the memory calls used by Short Wave Log.  Short Wave Log
  257.           requires real hardware EMS 4.0 memory, not software EMS 4.0
  258.           memory emulation.
  259.  
  260.  
  261.  
  262.           Demo vs Registered Versions          Demo vs Registered Versions          Demo vs Registered Versions
  263.  
  264.           The demonstration and registered versions of Short Wave Log are
  265.           identical with one exception: the "please register me" message
  266.           only appears in the demonstration version.
  267.  
  268.  
  269.           Environment Variable          Environment Variable          Environment Variable
  270.  
  271.           Short Wave Log displays a clock in the upper right-hand corner of
  272.           the screen.  The clock can be set to either local time or
  273.           GMT/UTC.  If GMT/UTC is the preference, then Short Wave Log must
  274.           know the time difference between local time and GMT/UTC.
  275.  
  276.           The time difference is read from the DOS environment variable TZ,
  277.           where TZ=zzz[+/-]d[d]lll.  zzz is a three letter abbreviation for
  278.           the standard time zone.  The [+/-]d[d] field contains one or more
  279.           digits telling the number of hours the local time zone is west of
  280.           GMT/UTC.  For zones east of GMT/UTC, prefix the number with a
  281.           minus sign (e.g. -1 for Continental Europe).  The lll field is
  282.           used if daylight savings time is currently being used; it too is
  283.           a three letter field.
  284.  
  285.  
  286.                               Time Zone:      Set TZ to:
  287.                           Eastern Standard  EST5
  288.                           Eastern Daylight  EST5EDT
  289.  
  290.                           Central Standard  CST6
  291.                           Central Daylight  CST6CDT
  292.                           Mountain Standard MST7
  293.  
  294.                           Mountain Daylight MST7MDT
  295.                           Pacific Standard  PST8
  296.                           Pacific Daylight  PST8PDT
  297.  
  298.  
  299.  
  300.           Configuration File          Configuration File          Configuration File
  301.  
  302.           The environment variables and command-line options of earlier
  303.           versions have been replaced by the ASCII configuration file
  304.  
  305.  
  306.                                        Page 5
  307.  
  308.  
  309.  
  310.  
  311.  
  312.           SWLOG.CFG.  The following items are set in the configuration
  313.           file:
  314.  
  315.                       Registration number
  316.                       User name and address (used for QSL requests)
  317.                       BIOS screen writes
  318.                       CGA snow elimination
  319.                       Swap to EMS/XMS or disk
  320.                       Display the clock using local time or GMT/UTC.
  321.                       Monochrome display
  322.                       Frequencies shown in MHz or kHz
  323.                       Name of an ASCII editor to edit the QSL requests
  324.  
  325.  
  326.  
  327.           Main Menu          Main Menu          Main Menu
  328.  
  329.           Once the program is started, an initial welcome screen and
  330.           copyright notice is displayed.  To remove the message, press any
  331.           key or wait a few seconds until the delay is over.  If the
  332.           demonstration version is run, a "please register me" screen is
  333.           displayed.
  334.  
  335.           After the welcome screen disappears, the program is ready for
  336.           use.  On the top of the screen is a five-part menu and a clock,
  337.           which displays the current local time or GMT/UTC.  The main menu
  338.           is divided into five sub-menus:
  339.  
  340.                     ______                    System:   Re-display the welcome screen; Show a list of
  341.                               ASCII characters; Shell to DOS; Display
  342.                               information about the system; Quit the
  343.                               program.
  344.  
  345.                     ________                    Freqlist: Append, browse, edit, delete, and print the
  346.                               records in the FREQLIST table.
  347.  
  348.                     _______                    Logfile:  Append, browse, edit, delete, and print the
  349.                               records in the LOGFILE table.
  350.  
  351.                     ________                    Stations: Append, browse, display, edit, delete, and
  352.                               print the records in the STATION table.
  353.  
  354.                     _____                    Utils:    Export the tables to CSV files; Import data
  355.                               from CSV or dBASE III/III+ files; Generate a
  356.                               reception report; Rekey the tables.
  357.  
  358.  
  359.           System Menu          System Menu          System Menu
  360.  
  361.           General information about the program and computer is accessed
  362.           through the system menu.  There are five choices to the system
  363.           menu:
  364.  
  365.  
  366.  
  367.                                        Page 6
  368.  
  369.  
  370.  
  371.  
  372.  
  373.                     ______                    About:    This function shows the welcome message that
  374.                               appeared upon first entering the program.
  375.                               The current version of the program is
  376.                               displayed.
  377.  
  378.                     _____ _____                    ASCII Chart:        This function displays an ASCII
  379.                               chart.  It may be called at any time via the
  380.                               [Alt-A] key combination.  This is useful for
  381.                               entering non-English character on a US/UK
  382.                               keyboard (e.g. Sudwestfunk).
  383.  
  384.                     __ _____                    OS Shell: This function temporarily exits the program
  385.                               and presents the normal DOS prompt.  While in
  386.                               DOS, any DOS command may be issued; however,
  387.                               if any of the database tables are changed or
  388.                               deleted, irreparable damage may be inflicted
  389.                               to the tables.
  390.  
  391.                               This function is not available when running
  392.                               under DESQview as it can spawn DOS processes.
  393.  
  394.                     ______ _____                    System Info.:       This function shows various details
  395.                               about the system such as the type of CPU and
  396.                               co-processor, the amount of free
  397.                               conventional, EMS, and XMS memory.
  398.  
  399.                     ____                    Quit:     This function quits the program by closing
  400.                               all open files and reallocating all used
  401.                               memory.  This is the only safe way to exit
  402.                               the program.  It is not safe to exit by
  403.                               rebooting or turning off the computer since
  404.                               this may destroy all or part of the tables.
  405.                               The program may be quit at any time by using
  406.                               the [Alt-X] key combination.
  407.  
  408.  
  409.  
  410.           Freqlist Menu          Freqlist Menu          Freqlist Menu
  411.  
  412.           Access to the FREQLIST table is obtained via the freqlist menu.
  413.           FREQLIST is a Paradox table with the following structure:
  414.  
  415.                     Khz       N
  416.                     Station   A35
  417.                     Location  A35
  418.                     Kw        N
  419.  
  420.           The FREQLIST table is used to aid the entering of a record into
  421.           the LOGFILE table.  For example, say the BBC on 9590 kHz is being
  422.           entered into the LOGFILE table.  The program maps 9590 kHz into
  423.           the FREQLIST table and finds all matching entries.  Both the BBC
  424.           and Radio Netherlands are found.  The user then chooses the
  425.           correct station and the program presents the user with the
  426.           corresponding information for the transmitter location and power.
  427.  
  428.                                        Page 7
  429.  
  430.  
  431.  
  432.  
  433.  
  434.           If no matches are found, then the user is simply not presented
  435.           with any suggestions.  If the suggestions are incorrect, the user
  436.           need only press the [Esc] key to disregard them.
  437.  
  438.           Short Wave Log is shipped with a FREQLIST table containing
  439.           approximately 470 records.  The frequencies are current for the
  440.           winter of 1991.
  441.  
  442.           There are five choices to the freqlist menu:
  443.  
  444.                     ______                    Append:   This function appends records to the FREQLIST
  445.                               table.  Once selected, the user is presented
  446.                               a form in which to enter data.
  447.  
  448.                     ______                    Browse:   This function allows the viewing and editing
  449.                               of many records on the screen at one time.
  450.                               This function is contained in the file
  451.                               BROWSE.EXE.  The Short Wave Log program is
  452.                               swapped to EMS, XMS, or disk when this
  453.                               function is called.  The swapping method may
  454.                               not be compatible with every expanded and
  455.                               extended memory manager.  If the swap crashes
  456.                               the system, it can be forced to disk by
  457.                               setting an option in the configuration file.
  458.  
  459.                               To make more disk space available for log
  460.                               entries, the browse function is not available
  461.                               when run from a floppy drive.
  462.  
  463.                     ___________                    Edit/Delete:        This function edits and deletes
  464.                               existing records in the table.  The program
  465.                               maintains keys, or indices, to the table.
  466.                               Prior to entering the edit form, the user is
  467.                               prompted to choose the desired key and enter
  468.                               the search data.  The corresponding record is
  469.                               then found in the table.
  470.  
  471.                               If run from a floppy drive, only the primary
  472.                               key is used to save disk space.
  473.  
  474.                     _____                    Print:    This function prints the table to a file
  475.                               chosen by the user.  The output is sorted
  476.                               according to one of the table's keys:
  477.                               frequency, station name, or transmitter
  478.                               location.  To print directly to a printer,
  479.                               give the name of the port to which the
  480.                               printer is attached (e.g. PRN:, LPT1:).
  481.  
  482.                     ____ ___                    Char Set: This function determines whether the Print
  483.                               Freqlist function uses 7- or 8-bit ASCII
  484.                               characters.  While all PC's can display 8-bit
  485.                               characters, some printers cannot.
  486.  
  487.  
  488.  
  489.                                        Page 8
  490.  
  491.  
  492.  
  493.  
  494.  
  495.           The Append and Edit/Delete functions share the same data entry
  496.           form; however, the Edit/Delete form has additional keys defined
  497.           to allow the user to move from record to record.  While in either
  498.           function, the Escape key aborts the function.  The key bindings
  499.           specific to the Edit/Delete function follow:
  500.  
  501.                     [F2]      Choose a new search key.
  502.                     [F3]      Delete the current record.
  503.                     [F9]      Go to the first record in the table.
  504.                     [F10]     Go to the last record in the table.
  505.                     [PgUp]    Go to the previous record.
  506.                     [PgDn]    Go to the next record.
  507.  
  508.           The browse function has the following key bindings:
  509.  
  510.                     [F1]      Help screen
  511.                     [UpArr]   Previous record
  512.                     [DnArr]   Next record
  513.                     [LtArr]   Next field to the left
  514.                     [RtArr]   Next field to the right
  515.                     [PgUp]    Previous page of records
  516.                     [PgDn]    Next page of records
  517.                     [Ctrl-PgUp]         Top of table
  518.                     [Ctrl-PgDn]         Bottom of table
  519.                     [Home]    First field
  520.                     [End]     Last field
  521.                     [Ctrl-End]          Go to a specific record
  522.                     [Delete]  Delete current record
  523.                     [BSpace]  Edit current field
  524.                     [Enter]   Accept edit
  525.                     [Esc]     Abort edit or exit function
  526.  
  527.  
  528.  
  529.           Logfile Menu          Logfile Menu          Logfile Menu
  530.  
  531.           Access to the LOGFILE table is obtained via the logfile menu.
  532.           LOGFILE is a Paradox table with the following structure:
  533.  
  534.                     Date      D
  535.                     Gmt       A4
  536.                     Khz       N
  537.                     Mode      A4
  538.                     Sinpo     A5
  539.                     Station   A35
  540.                     Location  A35
  541.                     Kw        N
  542.                     Language  A2
  543.                     Detail1   A50
  544.                     Detail2   A50
  545.                     Detail3   A50
  546.  
  547.           The LOGFILE table is used to store the user's logs.  When
  548.           entering a record, the user is presented with pop-up windows for
  549.  
  550.                                        Page 9
  551.  
  552.  
  553.  
  554.  
  555.  
  556.           the mode, station name, transmitter location, power, and
  557.           language.  The suggestions for the station name, transmitter
  558.           location, and power pop-up windows come from data in the FREQLIST
  559.           table.  If there are no corresponding matches in the FREQLIST
  560.           table, then there is no pop-up window.  If the suggestions are
  561.           incorrect, the user need only press the Escape key to disregard
  562.           them.
  563.  
  564.           There are the same options to the LOGFILE menu as the FREQLIST
  565.           menu with one addition:
  566.  
  567.                     _____ ___                    Print Key:          This function prints only those
  568.                               records matching a given key (e.g. only the
  569.                               records from the BBC).  The user is prompted
  570.                               for the filename.
  571.  
  572.  
  573.  
  574.           Stations Menu          Stations Menu          Stations Menu
  575.  
  576.           Access to the STATION table is obtained via the stations menu.
  577.           STATION is a Paradox table with the following structure:
  578.  
  579.                     Name      A35
  580.                     Address1  A35
  581.                     Address2  A35
  582.                     Country   A35
  583.  
  584.           There are the same options to the STATIONS menu as the FREQLIST
  585.           menu with one addition:
  586.  
  587.                     _______                    Display:  This function presents the user with a pop-up
  588.                               window of all the station names.  The user
  589.                               can choose a station (or abort the function
  590.                               via the Escape key) and see the address of
  591.                               the station.
  592.  
  593.  
  594.           Utils Menu          Utils Menu          Utils Menu
  595.  
  596.           Contained in the utils menu are functions that do not fit in the
  597.           other menus.  There are four choices to the utils menu:
  598.  
  599.                     ______                    Export:   This function exports the data from the
  600.                               FREQLIST, STATION, and SWL tables into ASCII
  601.                               files formatted to the CSV (Comma Separated
  602.                               Values) specification.  A CSV file is a
  603.                               comma-delimited ASCII file with double
  604.                               quotation marks surrounding text fields.  The
  605.                               CSV files can then be imported by another
  606.                               database or spreadsheet.  The fields are in
  607.                               the same order as described above.
  608.  
  609.  
  610.  
  611.                                        Page 10
  612.  
  613.  
  614.  
  615.  
  616.  
  617.                     ______                    Import:   This function imports data from a CSV or
  618.                               dBASE file into the corresponding tables
  619.                               (i.e. the data in a FREQLIST.DBF file is
  620.                               imported into the FREQLIST table).  Both the
  621.                               CSV and DBF files must be in a specific
  622.                               format.  The required format for each table
  623.                               can be found in the on-line help.
  624.  
  625.                     ___ ______                    QSL Writer:         This function writes a reception
  626.                               report (a QSL request) in a variety of
  627.                               languages.  Currently Short Wave Log writes
  628.                               reports in English, Finnish, German, Spanish,
  629.                               and Swedish.  The QSL Writer cannot be
  630.                               accessed unless running DOS 3.30 or later.
  631.  
  632.                               When this function is selected, the user is
  633.                               presented with two forms.  In the first form,
  634.                               the user enters his name and address; the
  635.                               name and address of the station; the date,
  636.                               time, and frequency of the broadcast; the
  637.                               quality of the signal strength, background
  638.                               noise, and overall transmission quality of
  639.                               the broadcast.  Finally the user chooses the
  640.                               desired language for the report.  A list of
  641.                               stations from the STATION table is presented
  642.                               in a pop-up window for thestation name field.
  643.                               If a station is chosen, its address is placed
  644.                               into the appropriate fields of the form.
  645.  
  646.                               In the second form the user enters details
  647.                               about the program that he has heard.  If a
  648.                               language other than English is chosen, a
  649.                               pop-up window of program details is
  650.                               presented.  The chosen program detail is
  651.                               translated into the appropriate language.
  652.  
  653.                               The text for the QSL request is stored in
  654.                               files with the extension of QSL (e.g.
  655.                               ENGLISH.QSL).  These files can be edited to
  656.                               the user's taste with any ASCII editor that
  657.                               supports 8-bit ASCII.
  658.  
  659.                               When both forms have been completed, the
  660.                               reception report is written to an ASCII disk
  661.                               file.  Note that this file is in 8-bit ASCII
  662.                               (to accommodate the non-English characters),
  663.                               and not all printers can print it.
  664.  
  665.                               After the QSL request is written to disk, the
  666.                               user is asked if he wants to edit the report.
  667.                               The name of the editor is defined in the
  668.                               SWLOG.CFG file.
  669.  
  670.  
  671.  
  672.                                        Page 11
  673.  
  674.  
  675.  
  676.  
  677.  
  678.                     _____                    Rekey:    Since there can be thousands, even millions,
  679.                               of records in a table, there must be a faster
  680.                               method to locate records other than to
  681.                               traverse the entire table from start to end.
  682.                               This is done with a series of keys, or
  683.                               indices.
  684.  
  685.                               Sometimes the keys become corrupt.  This can
  686.                               happen if the disk drive becomes full or a
  687.                               key is accidentally deleted.  If so, the
  688.                               program will detect the error and terminate
  689.                               with an error message.  Most often rekeying
  690.                               the tables will eliminate the error.
  691.  
  692.                               The tables may have to be rekeyed if the DOS
  693.                               country code is changed.  Currently three
  694.                               different sorting orders are used:
  695.                               International, Norwegian/Danish, and
  696.                               Swedish/Finnish.  The sort order is
  697.                               determined by the DOS country code.  If the
  698.                               tables and their indexes do not use the same
  699.                               sort order, the program will abort with the
  700.                               obscure error 
  701.  
  702.  
  703.           Backing Up Tables          Backing Up Tables          Backing Up Tables
  704.  
  705.           As with any program, it is a prudent idea to back up the tables
  706.           often.  All the data for Short Wave Log is stored in the
  707.           FREQLIST.DB, STATION.DB, and SWL.DB files.  
  708.  
  709.  
  710.           On-line Help          On-line Help          On-line Help
  711.  
  712.           All of the information contained in the user's guide is also
  713.           available within the Short Wave Log program.  To access the
  714.           on-line help, press the [F1] key at any time.
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.                                        Page 12